Skip to content

data(knowledge): 실행 Slot 계약과 E2E Gold 후보 확장 - #52

Merged
hywznn merged 2 commits into
mainfrom
agent/workflow-slot-e2e-contract
Aug 16, 2026
Merged

data(knowledge): 실행 Slot 계약과 E2E Gold 후보 확장#52
hywznn merged 2 commits into
mainfrom
agent/workflow-slot-e2e-contract

Conversation

@hywznn

@hywznn hywznn commented Aug 13, 2026

Copy link
Copy Markdown
Member

목적

FOWOCO 데모에서 사용하는 필드와 재계약·체류연장 시나리오를 Knowledge 0.3.0의 원본 계약으로 고정합니다. UI·AI·Server가 서로 다른 필수값과 Workflow 순서를 하드코딩하지 않도록 Slot 의미, 데이터 출처, 담당 주체, 검증 규칙과 대표 E2E 기대값을 한곳에서 관리합니다.

Closes #51

변경 내용

  • 8개 Workflow의 Slot에 한글 표시명, 쉬운 표현, 출처 우선순위, 담당 주체와 검증 규칙 추가
  • 기존 required, optional, resolvable_from_context 구조 유지
  • Server에서 사용하는 passport_status, arc_status를 Knowledge 소유 조회형 Context Slot으로 정의
  • 문서 상태 enum을 MISSING | SUBMITTED | VERIFIED로 고정하고 원문 식별정보를 제외
  • 단일 EXPIRY_RENEWAL에서 WF-CON-001 → WF-STY-001을 분리·확인하는 대표 데모 사례 추가
  • 이름 변형, 다중 후보, 복합 요청, 경계 Intent, OUT_OF_SCOPE, 베트남어 안내를 포함한 E2E Gold 후보 11건 구성
  • 내부 key 노출, 핵심값 보존, 개인정보 패턴, Guardrail, SHA-256을 자동 검증
  • Reviewer A/B 검수 템플릿과 Gold 승격 기준 문서화
  • Knowledge pack과 Python package version을 0.3.0으로 갱신

계약 결정

WF-STY-001

  • 필수: worker_id, due_at
  • 선택·조회 가능: stay_expiry_date, passport_status, arc_status
  • passport_status, arc_status는 문서 원문이 아니라 Server가 문서 메타데이터에서 계산하는 상태값
  • HR 승인 없이 외부 제출·근로자 발송·업무 완료 금지

대표 갱신 흐름

EXPIRY_RENEWAL
  → WF-CON-001 근로계약 갱신·고용허가기간 연장 준비
  → WF-STY-001 체류기간 연장 준비·제출 추적

이는 복수 Intent를 강제하는 계약이 아니라, 하나의 Intent가 여러 독립 Workflow로 구체화되는 계약입니다.

영향 범위

  • Knowledge 데이터·검증기·테스트·문서만 변경
  • Server DB와 Flyway 변경 없음
  • Client Public API 변경 없음
  • AI·Server는 후속 작업에서 0.3.0 Context Pack을 pin하고 하드코딩 fallback/projection을 맞춰야 함
  • 독립 검수 전 E2E 데이터는 Gold가 아니라 Gold 후보로만 사용

검증

  • git diff --check
  • make check
  • Ruff format/check 성공
  • Knowledge validation: VALID: FOWOCO Knowledge 0.3.0
  • Pytest: 20 passed

@hywznn
hywznn marked this pull request as ready for review August 16, 2026 00:36
@hywznn
hywznn merged commit 12e3155 into main Aug 16, 2026
4 checks passed
@hywznn
hywznn deleted the agent/workflow-slot-e2e-contract branch August 16, 2026 00:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

data(knowledge): 실행 Slot 계약과 E2E Gold 후보 확장

1 participant